*! Given by Yujun Lian, Zhonghao Wei
*! V1.2.2 2019/1/12 15:40
*
*help appendfiles                                                                                        
*--------------------------------------------------------------------------------------------------------
*
*Title
*
*
*    appendfiles -- Appends all .txt files in the specified directory.
*
*
*Syntax
*
*        appendfiles directory [,saving(path\filename)]
*
*
*Description
*
*    directory is a valid specified directory that contains .txt files.
*    All .txt files in the specified directory would be appended in the order of their names.
*    The option saving() allows users to specify the name and the saving directory of the generated
*    .txt file.
*
*
*Option
*
*    saving(path\filename): specify the name and the saving directory of the generated .txt file.
*
*    Other languages are not recommended in the option saving() compared with English. If users have to
*   use Chinese characters in saving(), please be sure that the directory already exists, and please
*    do not specify the extension ".txt"
*
*    The default filename of the generated .txt file is "appendfiles_output.txt", and the default
*    saving folder is the specified input directory.
*    Users could specify the saving folder by adding the directory before the filename. The string
*   after the last "\" in the saving(path\filename) would be recognized as the filename
*    If users only specify the filename without the saving folder, the default saving folder is the
*    input directory.
*
*
*
*Examples
*
*    appendfiles D:\example
*    Appends every .txt file in the directory "D:\example". The saving folder is the same as
*   "D:\example", and the name of the generated file is "appendfiles_output.txt"
*
*   appendfiles D:\example, saving(newtxtfile)
*    Appends every .txt file in the directory "D:\example". The saving folder is the same as
*    "D:\example", and the name of the generated file is "newtxtfile.txt"
*
*    appendfiles D:\example, saving(D:\output\newtxtfile)
*    Appends every .txt file in the directory "D:\example". The saving folder is "D:\output", and the
*    name of the generated file is "newtxtfile.txt"
*
*
*
*Authors
*
*    Yujun Lian (Arlion)
*        Department of Finance, Lingnan College, Sun Yat-Sen University.
*        E-mail: arlionn@163.com.
*
*    Zhonghao Wei
*        Lingnan College, Sun Yat-Sen University.
*        E-mail: wwwwwxiaowei@163.com.
*


﻿{smcl}
{* 12 Jan 2019}{...}
{cmd:help appendfiles}{right: }
{hline}

{title:Title}


{phang}
{bf:appendfiles} {hline 2} Appends all .txt files in the specified directory.


{title:Syntax}

{p 8 18 2}
{cmdab:appendfiles} {it:directory} [,{it:saving(path\filename)}]


{marker description}{...}
{title:Description}

{pstd}{it:directory} is a valid specified directory that contains .txt files. {p_end}
{pstd} All .txt files in the specified directory would be appended in the order of their names. {p_end}
{pstd} The option {it:saving()} allows users to specify the name and the saving directory of the generated .txt file. {p_end}


{marker options}{...}
{title:Option}

{phang}
{it:saving(path\filename)}: specify the name and the saving directory of the generated .txt file. {p_end}

{pstd} Other languages are not recommended in the option saving() compared with English. If users have to use Chinese characters in saving(), please be sure that the directory already exists, and please do not specify the extension ".txt" {p_end}

{pstd} The default filename of the generated .txt file is "appendfiles_output.txt", and the default saving folder is the specified input directory. {p_end}
{pstd} Users could specify the saving folder by adding the directory before the filename. The string after the last "\" in the {it:saving(path\filename)} would be recognized as the filename {p_end}
{pstd} If users only specify the filename without the saving folder, the default saving folder is the input directory. {p_end}



{title:Examples}

{pstd} appendfiles D:\example {p_end}
{pstd} Appends every .txt file in the directory "D:\example". The saving folder is the same as "D:\example", and the name of the generated file is "appendfiles_output.txt" {p_end}

{pstd} appendfiles D:\example, saving(newtxtfile) {p_end}
{pstd} Appends every .txt file in the directory "D:\example". The saving folder is the same as "D:\example", and the name of the generated file is "newtxtfile.txt" {p_end}

{pstd} appendfiles D:\example, saving(D:\output\newtxtfile) {p_end}
{pstd} Appends every .txt file in the directory "D:\example". The saving folder is "D:\output", and the name of the generated file is "newtxtfile.txt" {p_end}



{title:Authors}

{phang}
Yujun Lian (Arlion) {break}
Department of Finance, Lingnan College, Sun Yat-Sen University. {break}
E-mail: {browse "mailto:arlionn@163.com":arlionn@163.com}.
{p_end}

{phang}
Zhonghao Wei {break}
Lingnan College, Sun Yat-Sen University. {break}
E-mail: {browse "mailto:wwwwwxiaowei@163.com":wwwwwxiaowei@163.com}.